home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / ZIPPED / WINDOWS / GRAPHICS / PIXFOL20.ZIP / PIXREAD.ME < prev    next >
Text File  |  1992-10-12  |  22KB  |  587 lines
  1. PixFolio - Windows Image Viewer and Catalog Manager (Shareware)
  2.             Pre-release version 2.0 (Beta)
  3.  
  4. (c) Allen C. Kempe, 1992. All rights reserved.
  5.  
  6. Portions (c) Microsoft Corporation, 1985-1992. All rights reserved.
  7.  
  8. WARNING!!!
  9.  
  10. This version is test software and as such may contain potentially damaging
  11. bugs. The user should take the necessary precautions to insure that valued
  12. information on his or her system is protected and backed up.
  13.  
  14. The author would appreciate being notified of bugs and problems that you
  15. encounter. If you report a problem, please try to fully detail what steps you
  16. took to encounter the error. The preferred contact method is via CompuServe.
  17. My address is 71220,23.
  18.  
  19. ****************************************************************************
  20.  
  21. PixFolio is a Microsoft Windows program that can view a
  22. variety of bitmapped graphics formats and maintain multiple catalogs of
  23. images.
  24.  
  25. The graphics formats currently supported are:
  26.     BMP/DIB-Windows Bitmap
  27.     CLP -   Windows clipboard file
  28.     DRW/GRF - Micrografx draw and graph files.
  29.     EPS -   Encapsulated Postscript with imbedded TIFF preview images.
  30.     FLI/FLC - Autodesk Animator and Animator Pro (tm) files.
  31.     GIF -   CompuServe Graphics Interchange Format
  32.     ICO -   Windows Icon
  33.     IFF -   IFF/LBM (Amiga) used by Computer Eyes frame grabber.
  34.     IMG -   GEM/IMG (Digital Research).
  35.     JPG -   JPEG
  36.     MAC -   Macintosh MacPaint files.
  37.     PCX -   Microsoft Paint & PC Paintbrush
  38.     RLE -   Compuserve Run Length Encoded
  39.     TGA -   Targa
  40.     TIFF-   Tag Image Format. Most formats including 24 bit color
  41.             are supported.
  42.     WMF -   Windows Metafile.
  43.     WPG -   WordPerfect Graphics
  44.  
  45. Note: Not all variations that may be possible in the above file formats have
  46. been tested due to lack of suitable test files.
  47.  
  48. The major feature of PixFolio is the ability to build catalogs of
  49. images, that may reside on different disks. The catalog can then be searched
  50. and images can be easily located. Provisions are made for saving a primary and
  51. backup location for the image concurrently. To enhance searching for a
  52. particular image the program can display postage stamp images in a matrix.
  53.  
  54. The ability to read an image in one format and to save it in another allows
  55. the program to be used as a file conversion utility.
  56.  
  57. PixFolio version is test software under development. The author requests that
  58. copies of this version of PixFolio not be distributed to other parties without
  59. the author's permission.
  60.  
  61.  
  62. THE AUTHOR RESERVES ALL RIGHTS TO THIS PROGRAM. THE AUTHOR DOES NOT WARRANT
  63. THIS PROGRAM'S FITNESS OR SUITABILITY FOR ANY PURPOSE. ALL USERS SHOULD USE
  64. IT AT THEIR OWN RISK.
  65.  
  66. The author will make a reasonable effort to correct problems and software
  67. bugs relating to documented features of the program for registered users.
  68. The author intends to make continuing improvements to the program including
  69. supporting additional file formats. To this end, comments and suggestions are
  70. welcomed.
  71.  
  72. Users may contact the author, Allen C. Kempe on CompuServe (71220,23), on
  73. GEnie at A.KEMPE or in writing at:
  74.  
  75.         Allen C. Kempe
  76.         298 W. Audubon Drive
  77.         Shepherdsville, KY 40165-8836
  78.         USA
  79.  
  80.     The Author is a member of the Association of Shareware Professionals.
  81.  
  82.  
  83. Main Features
  84.     PixFolio utilizes Microsoft's MDI (Multiple Document Interface) so that
  85.     multiple images can be open concurrently.
  86.  
  87. File Menu:
  88.     New File - create a blank image suitable for pasting from the
  89.            clipboard.
  90.     Open File - Open a new file for viewing.
  91.     Save File - Save an image, possibly in a different format.
  92.     Move/Copy file - Move or copy a file.
  93.     Delete - Delete a file.
  94.     Print - print all or part of an image.
  95.     Select Printer - select a printer
  96.     Close
  97.  
  98. Catalog Menu:
  99.     Select catalog: Create, delete, select or rename an image catalog.
  100.     Catalog. Create or update a catalog entry for a displayed image.
  101.     Browse Catalog. View catalog entries one by one; select a subset
  102.                     for viewing.
  103.     Build Catalog. Create catalog entries for groups of images.
  104.     View thumbnails of catalog entries.
  105.     Print Catalog Entries. Two formats are provided.
  106.     Export - Export the contents of a catalog for input to a database
  107.          or spreadsheet.
  108.     Rebuild Catalog Index. Recover lost space in file and compact it.
  109.  
  110. Edit Menu:
  111.     Paste palette and image from clipboard.
  112.     Copy all or part of an image to the clipboard.
  113.     Cut a selected area from an image.
  114.     Crop an image.
  115.     Expand an image to fill the dimensions of the current window.
  116.     Resize an image by a percentage amount or fit to a given dimension.
  117.  
  118. Options:
  119.     Set background color used when image is expanded.
  120.     Set whether to use a solid or pattern background color.
  121.     Display DIB or Bitmap format.
  122.     Control whether warning messages will be displayed.
  123.     Establish default operating options.
  124.  
  125. Palette Options:
  126.     Palette manipulation (Brightness and contrast).
  127.     Convert to gray scale.
  128.     Dither to Black & White or color palette.
  129.     Play a GIF animation sequence.
  130.     Single step through a GIF animation sequence.
  131.     Change the speed of a GIF animation sequence.
  132.  
  133. Capture:
  134.     Capture the contents of another screen or the Windows desktop.
  135.  
  136. Other:
  137.     Using the mouse in the main viewing window, a marquee can be
  138.     selected for copying or cutting to the clipboard. The right mouse
  139.     button can be used to draw a stretch marquee where the selected
  140.     image rectangle is copied.
  141.  
  142. Help:
  143.     Context sensitive help is included for all menu items.
  144.  
  145. **** Other Features ****
  146.  
  147.     PixFolio version 2.0 supports OLE version 1.0 as a server only. PixFolio
  148.     will automatically register itself as an OLE server the first time that it
  149.     is executed.
  150.  
  151.     PixFolio will accept "Drag and Drop" filenames from File Manager.
  152.  
  153. ******** Equipment Requirements **********
  154.  
  155. While PixFolio will execute in a minimal Windows installation, for example, a
  156. 286 with 2 megabytes of memory, program operation will be severely inhibited
  157. by a lack of memory. On such a configuration, large bitmaps, especially 8 or
  158. 24 bit images may fail. Other applications could be adversely affected as
  159. well and fail with unexpected UAE's. Actual results will vary depending upon
  160. the amount of memory used by other applications running concurrently.
  161.  
  162. PixFolio was developed and tested on a 20-MHz 386 with 8 megabytes of memory.
  163. It is recommended that PixFolio be run on a machine with at least 4 and pre-
  164. ferrably, 6 megabytes of memory. Running in 386-Enhanced mode will also
  165. make available the benefits of virtual memory.
  166.  
  167. The display of images containing more than 16 colors requires that you have
  168. a Super VGA or better video display and a 256 color Windows device driver in
  169. order to display the full range of colors in the image. However, PixFolio
  170. incorporates dithering functions that will allow display of a 256
  171. color image using a 16 color driver such as the standard VGA driver. Such
  172. operations are slow and the results are not as good as if you have a video
  173. display capable of displaying 256 colors.
  174.  
  175. ********** Program Limitations *************
  176.  
  177. PixFolio has no limit on the number of catalogs that can be created or the
  178. size of these catalogs except those restraints imposed by your file system
  179. and te amount of available memory. However, the following points should be
  180. noted:
  181.  
  182. 1. PixFolio 2.0 will only run under Windows 3.1 or higher. Catalog file
  183.    formats are compatible with PixFolio version 1.04.
  184.  
  185. 2. The size of a catalog is limited by the amount of disk space where it
  186.    resides or 2,048 index entries. Catalog records are variable length and
  187.    depend upon the type of image and how big the comments are.
  188.  
  189. 3. PixFolio may encounter difficulty with extremely large images, those in
  190.    excess of 1024 x 768 pixels. This is particularly true of color images
  191.    and even more so by 24 bit color or gray scale images. This is primarily
  192.    due to the increased memory requirements.
  193.  
  194. 4. While PixFolio and Windows supports 24 bit color and gray scale images,
  195.    the display of such images using a video driver that only displays 256
  196.    colors, can result in some lengthy delays whenever windows has to realize
  197.    the 24 bit RGB data to an 8 bit palette. It may take 15 to 20 minutes to
  198.    realize a 640 x 480 image depending upon the speed of your machine.
  199.    Dithering a 24 bit image to 256 colors can take more than an hour in some
  200.    cases. If you plan to work with 24 bit images, you may wish to invest in
  201.    a video board that supports "high color". One such board that appears to
  202.    work quite well is the ATI VGASTEREO F/X card.
  203.  
  204. 5. The support for GIF animation in PixFolio requires large amounts of free
  205.    memory. GIF animation files with a large number of frames or overlays may
  206.    unexpectedly fail if PixFolio runs out of memory.
  207.  
  208.    Autodesk FLI/FLC animation files likewise require large amounts om memory.
  209.    To provide maximum performance, the entire image is loaded into memory to
  210.    reduce delays caused by reading from disk. A lack of physical memory that
  211.    requires Windows to utilize paged virtual memory (in 386 Enhanced mode)
  212.    can result in "jumpy" animations. In addition a high performance video
  213.    board and driver is recommended to optimally display animation files
  214.    without pauses that destroy the effect.
  215.  
  216. 6. PixFolio has not been rigorously tested in a network environment. The
  217.    affect of network operations and more than one user accessing PixFolio
  218.    files concurrently cannot be predicted.
  219.  
  220. 7. Not all graphics formats are supported equally with respect to reading and
  221.    saving a file. For example, not all of the compression options are
  222.    currently supported for saving TIFF images. GIF images can only be saved
  223.    in GIF87a format. Likewise, some of the more obscure or obsolete formats
  224.    such as 4 color CGA formats for PCX cannot be written although they can be
  225.    read.
  226.  
  227.    CCITT Group 4 TIFF file comprssion formats are not supported at this time.
  228.  
  229. 8. The author has not been able to test PixFolio with printers that print in
  230.    color in Windows 3.1 except for an Epson 2550.
  231.  
  232.    One user has reported that PixFolio give very good results printing color
  233.    images on Start Micronics NX-1000 Rainbow and NX-1020 printers but you must
  234.    obtain the OEM driver from Star Micronics.
  235.  
  236.    Printer performance when running under Windows 3.1 is much improved. It is
  237.    both faster as well as of higher quality. Changes to the printer drivers
  238.    also enable printing to color printers such as the Epson LQ-2550.
  239.  
  240. 9. The implementation of Micrografx .DRW and .GRF files is not rigorous. Some
  241.    features of these files are not supported. Unless you have Adobe Type
  242.    Manager or scalable typefaces, the rendition of fonts used in these files
  243.    may not be optimal when Windows matches fonts.
  244.  
  245. 10. Other program limitations, if any, can be determined by accessing the
  246.    online context-sensitive help.
  247.  
  248.  
  249. ****** Installation and Getting Started*******
  250.  
  251. If your copy of PixFolio was received on a distribution diskette, the
  252. installation should be done from within windows by running "SETUP" from drive
  253. A: or B: (whichever is appropriate). This is important as the files on a
  254. distribution diskette are compressed. Otherwise, the following installation
  255. procedure should be followed:
  256.  
  257. It is suggested that the files which constitute PixFolio be placed in their
  258. own subdirectory on your hard disk. These files are:
  259.  
  260.     PIXFOLIO.EXE
  261.     PIXFOLIO.HLP
  262.     SPIN.DLL
  263.     METER.DLL
  264.     PIXDLL.DLL
  265.     PIXIODLL.DLL
  266.     PIXHELP.DLL
  267.     PIXCATLG.DLL
  268.     PIXTIFF.DLL
  269.     PIXGIF.DLL
  270.     PIXFLIC.DLL
  271.     PIXWPG.DLL
  272.     PIXJPEG.DLL
  273.     PIXCNTRL.DLL
  274.  
  275.     The following files are Microsoft supplied DLL's that are necessary to
  276.     provide dialog services and other functionality. Note if you have Windows 3.1,
  277.     you should already have these files.
  278.  
  279.     COMMDLG.DLL
  280.     OLESVR.DLL
  281.     SHELL.DLL
  282.  
  283.  
  284. Once the above files have been located in the subdirectory of your choice,
  285. start Windows and then use the Program Manager "Add" command to add PixFolio
  286. to the desired program group.
  287.  
  288. When PixFolio runs for the first time, it will establish a section in
  289. your WIN.INI file with program variables. These default options should enable
  290. you to start using PixFolio immediately. Once PixFolio is running you may
  291. access the online Help command for specific instructions and explanation of
  292. PixFolio menu commands.
  293.  
  294. A quick review of PixFolio features and operating procedures can be gained by
  295. reviewing the user guide.
  296.  
  297. ****** Credits ******
  298.  
  299. The author of PixFolio would like to recognize the efforts of Mr. Paul Hachey,
  300. (CompuServe Id 76625,2644) who performed an invaluable service by getting
  301. deeply involved in the extensive testing that went on over a period of months.
  302. Paul is responsible for the design of the PixFolio cover page, Icon and
  303. "About" dialog box and his many suggestions greatly influenced the "look and
  304. feel" of PixFolio.
  305.  
  306. Other people who have participated in the testing of PixFolio include:
  307.  
  308.     Luis Alvarez
  309.     David Brune
  310.     Monte Davis
  311.     Sean Gonzalez
  312.     James Horner
  313.     Tom Little
  314.     John Sabo
  315.  
  316. Their help is appreciated.
  317.  
  318.  
  319. Recent Changes:
  320. ***** Version 2.0.27 *****
  321.  
  322. 200. Correct problem with setting default tile type in File Save As.
  323.  
  324. 201. Insure that default file save options are set properly before a File
  325.      Save is executed.
  326.  
  327. 202. Eliminate error message "Cannot Render Bitmap" that occurs when copying
  328.      to the clipboard and the DIB to Screen option is turned on.
  329.  
  330. 203. Insure that cancelling a read DRW file will terminate clean without
  331.      extraneous errors or UAE's.
  332.  
  333. 204. Correct error that prevented creating a catalog on a removable drive
  334.      that was overridden with a "Primary Drive" parameter.
  335.  
  336. 205. Correct a crash that occurs when clicking on a thumbnail's title in
  337.      Alpha sequence.
  338.  
  339. 206. Added file size, date & time to Tech Info.
  340.  
  341. 207. Added help to error and warning messages associated with creating a new
  342.      catalog.
  343.  
  344. 208. Insure that thumbnail view gets re-drawn after a Catalog Build operation.
  345.  
  346. 209. Dropping a file on Pix now works.
  347.  
  348. ***** Version 2.0.28 *****
  349.  
  350. 210. Got JPEG version 3 working.
  351.  
  352. 211. Fix favorite directory commands so that they set the DOS current drive.
  353.  
  354. 212. Correct TIFF and TGA write routines to pass the correct file name. Also,
  355.      correct error message if write fails to "Error writing file".
  356.  
  357. 213. Allow Cancel button on Build dialog to be used while a Build is going
  358.      on to cancel the Build.
  359.  
  360. 214. Check "Stop on Error" and if not on, proceed after an error during a
  361.      build operation.
  362.  
  363. 215. Correct creation of thumbnails for 2 color images so that the colors
  364.      aren't reversed.
  365.  
  366. 216. Display the same list of supported file types that appears for file
  367.      open for the Build dialog.
  368.  
  369. 217. Add necessary logic to read Group 3 FAX files.
  370.  
  371.  
  372. 218. Add support for CompuServe RLE files.
  373.  
  374. ***** Version 2.0.29 *****
  375.  
  376. 219. Eliminate possibility of causing a GPF if user presses the "Update"
  377.      button while the thumbnail bitmap is being created.
  378.  
  379. 220. Eliminated bogus error "file already exists at ...." when re-cataloging
  380.      an image.
  381.  
  382. ***** Version 2.0.30 *****
  383.  
  384. 221. Add '&' operator for searches to do a logical AND of search criteria.
  385.  
  386. 222. Fix TIFF write compress option.
  387.  
  388. 223. Allow up to 60k of Description data in catalog description entries.
  389.  
  390. 224. Prevent a 2nd copy of PixFolio from running.
  391.  
  392. ***** Version 2.0.31 *****
  393.  
  394. 225. Correct display of status bar when copying files.
  395.  
  396. 226. Improve status messages displayed while printing.
  397.  
  398. 227. Got rid of "Undefined Error" and "Cannot Allocate Memory" messages that
  399.      sometimes occurred while reading files. This error occurred when the
  400.      current data directory contained DLL's from PixFolio 1.04; as a result,
  401.      the 1.04 DLL of the same name got loaded instead of the 2.0 DLL.
  402.  
  403. 228. Correct a print error: "Play Metafile failed".
  404.  
  405. 229. Make Slideshow more responsive to clicking with the left mouse button to
  406.      stop.
  407.  
  408. 229. Correct file type list in Catalog Build.
  409.  
  410. 230. Stretch to Window option now maintains correct aspect ratio.
  411.  
  412. 231. Images that are larger than the screen in slide show will be shrunk
  413.      to fit.
  414.  
  415. 232. Correct generation of DIB bitmaps for WPG & CGM files; image is no
  416.      longer upside down.
  417.  
  418. 233. Correct translation of metafile formats to clipboard metafile formats.
  419.  
  420. ***** Version 2.0.32 *****
  421.  
  422. 234. Retrieve metafile from .CLP format if one is present.
  423.  
  424. 235. Restore the PixFolio window to normal size if if is an icon and a file
  425.      is dropped on it.
  426.  
  427. 236. Got rid of palette corruption that occurs before a slide change.
  428.  
  429. 237. Make sure that file save options are set to previous values when the
  430.      options button is pressed.
  431.  
  432. 238. Correct GPF that occured when selecting IFF format save. Correct
  433.      creation of 24 bit IFF files.
  434.  
  435. 239. Correct realization of user selected color resolution when saving files.
  436.  
  437. 240. Insure that file type dropown list is set to file type if a file is
  438.      slected from the listbox in File Save As.
  439.  
  440. 241. Correct GPF that occurs after displaying a file that was just read in.
  441.  
  442. 242. Implement compression option for LBM/IFF files.
  443.  
  444. 243. Display status bar if a bitmap has to be built during a file save
  445.      operation so the user doesn't think the machine is hung.
  446.  
  447. 244. Correct GPF that occurs when saving a 24 bit image in JPEG format.
  448.  
  449. 245. Correct error whereby bitmap memory objects are not getting deleted
  450.      during a print catalog operation resulting in an "out of memory"
  451.      condition.
  452.  
  453. 246. Eliminate some strange effects and probably a crash if the thumbnail
  454.      image is clicked during a Build operation.
  455.  
  456. 247. Correct palette corruption that occurs after slide show is done.
  457.  
  458. ***** Version 2.0.33 *****
  459.  
  460. 248. Insure that input focus is set to the Title entry box in the
  461.      catalog information dialog box after the Thumbnail is drawn.
  462.  
  463. 249. Fix palette corruption tot thethumbnail view window when another
  464.      image was opened or activated.
  465.  
  466. 250. Eliminate erase of child windows when another was created or destroyed.
  467.  
  468. 260. Correct percent display on print when certain larger font sizes were
  469.      being used.
  470.  
  471. 261. Correct GPF's and crashes when cancelling a print of a WPF or CGM file.
  472.  
  473. 262. Correct placement of Page number for thumbnail catalog print.
  474.  
  475. 263. Correct print of WPG, CGM and DRW images printing blank.
  476.  
  477. ***** Version 2.0.34 *****
  478.  
  479. 264. Add code to allow 1 and 4 bit IFF file saves.
  480.  
  481. 265. Move page number for full catalog prinout to lower right of page.
  482.  
  483. 266. Add Verify Catalog and Display Status Bar options to Default Options
  484.      dialog box.
  485.  
  486. 267. Add Delete Marked and Save Marked options to Process Thumbnails.
  487.  
  488. 268. Correct error in reading 24 bit files that causes these images to
  489.      be written (if saved in a different format) without a palette.
  490.  
  491. 269. Read the first frame of a FLIC animation when building a catalog so
  492.      that the thumbnail is not all black.
  493.  
  494. 270. Add help topic for Print dialog box.
  495.  
  496. 271. Add "omit description" option for Catalog Export function. If selected,
  497.      the description will be written out as a null field, i.e: "".
  498.  
  499. 272. Add "Repeat Show" option to slide show. Make sure that cursor is turned
  500.      off during slide show.
  501.  
  502. ***** Version 2.0.35 *****
  503.  
  504. 273. Make better use of available space to create as many thumbnails as
  505.      possible in Thumbnail View.
  506.  
  507. 274. Correct a problem with the "Export" button's text changing to "copy"
  508.      when the "Omit Description" checkbox is selected.
  509.  
  510. 275. Insure that minimum timeout occurs after last slide in slideshow.
  511.  
  512. 276. Correct writing of Slide repeat option to Win.INI.
  513.  
  514. 277. Insure foreground palette for slide show to eliminate corruption of
  515.      colors.
  516.  
  517. 278. Insure that the catalog for the active Thumbnail view is used for
  518.      a catalog print or export operation.
  519.  
  520. 279. Display 0% when starting a new page to print, not 100% until 1st
  521.      thumbnail has been formatted.
  522.  
  523. ***** Version 2.0.36 *****
  524.  
  525. 280. Correct display of CGM images with non-zero origins.
  526.  
  527. 281. Correct background color for CGM images.
  528.  
  529. 282. Correct interpretation of colors in CGM images when no Color Selection
  530.      Mode is specified.
  531.  
  532. 283. Correct erroneous display of help information after selecting Setup
  533.      option in the Print dialog.
  534.  
  535. 284. Correct "Favorite Directory" display the next time when an existing
  536.      entry other than the first is selected.
  537.  
  538. 285. Correct on-line help for error messages.
  539.  
  540. 286. Display hidden now works.
  541.  
  542. 287. Changed Export dialog so that checkbox now reads "Omit Description".
  543.  
  544. 288. Omit default extension list in File Save As which sometimes displays
  545.      as a blank selection.
  546.  
  547. 289. Apply horizontal scrolling to catalog tile entry to allow entry of
  548.      titles that are longer than the box.
  549.  
  550. 290. A default font named "Helvetica", 10 points, will be the default font
  551.      when a printer is selected for the first time.
  552.  
  553. 291. Eliminate extra screen repaint when moving the sliderbar in thumbnail
  554.      view.
  555.  
  556. 290. Correct invalid display that occurs when DIBToScreen and Center image
  557.      options are active: when the window is maximized, the image is displayed
  558.      with part of the leftmost portion of the image to the right and then
  559.      Windows "hangs". These symptoms ocurred when using an 8514 type video
  560.      display (8414, ATI Ultra, ATI Vantage, etc.).
  561.  
  562. 291. Change CGM read routine to eliminate realization of a new palette
  563.      during slide show resulting a corrupted pallete for the preceeding
  564.      slide.
  565.  
  566. ***** Version 2.0.37 *****
  567.  
  568. 292. Insure that favorite directory list gets appended to File menu even
  569.      when the child window is maximixed.
  570.  
  571. 293. Allow thumbnail to be dragged to a location in the catlog that is
  572.      not currently in view by scrolling the thumbnail view when the thumbnail
  573.      is dragged to the top or bottom of the thumbnail view window.
  574.  
  575. 294. Check for messages when displaying FLI files to insure that the user
  576.      can close the image.
  577.  
  578. 295. Restore previous window dimensions when "undoing" an operation such as
  579.      a rotate or expand.
  580.  
  581. 296. Double clicking with the right mouse button on an image will cause
  582.      the catalog card file dialog to be displayed.
  583.  
  584. 297. Correct problem reading compressed PCX files resulting in either a
  585.      partially corrupted image or a GPF.
  586.  
  587.